package com.gengzp.system.mapper;

import com.gengzp.common.model.user.entity.SysUser;
import com.gengzp.common.model.user.req.PageSysUserReq;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Collection;
import java.util.Date;
import java.util.List;

/**
 * @ClassName SysUserMapper
 * @Description 系统用户管理模块mapper层接口
 * @Author gengzp
 * @Date 2025/9/8 14:04
 */
@Mapper
public interface SysUserMapper {

    /**
     * 插入一条系统用户
     *
     * @param sysUser 系统用户
     */
    void insertSysUser(SysUser sysUser);

    /**
     * 根据id编辑系统用户
     *
     * @param sysUser 系统用户
     */
    void updateSysUserById(SysUser sysUser);

    /**
     * 根据id删除系统用户
     *
     * @param id 用户id
     */
    void deleteSysUserById(@Param("id") Long id);

    /**
     * 根据账号查询系统用户
     *
     * @param userAccount 用户账号
     * @return 系统用户
     */
    SysUser selectSysUserByAccount(@Param("userAccount") String userAccount);

    /**
     * 根据id查询系统用户
     *
     * @param id 系统用户id
     * @return 系统用户
     */
    SysUser selectSysUserById(@Param("id") Long id);

    /**
     * 根据昵称查询系统用户
     *
     * @param nickname 用户昵称
     * @return 系统用户
     */
    SysUser selectSysUserByNickname(@Param("nickname") String nickname);

    /**
     * 根据昵称模糊查询系统用户
     *
     * @param nickname 昵称
     * @return 系统用户集合
     */
    List<SysUser> fuzzySelectSysUserByNickname(@Param("nickname") String nickname);

    /**
     * 根据id查询系统用户集合
     *
     * @param ids 系统角色id集合
     * @return 系统角色集合
     */
    List<SysUser> selectSysUsersByIds(@Param("ids") Collection<Long> ids);

    /**
     * 分页查询系统用户
     *
     * @param req 分页查询参数
     * @return 系统用户集合
     */
    List<SysUser> pageQuerySysUser(PageSysUserReq req);

    /**
     * 查询系统用户数量
     *
     * @return 系统用户数量
     */
    Integer selectSysUserCount();

    /**
     * 根据最后修改时间的起始时间查询系统用户数量
     *
     * @param lastModifiedTimeStart 最后修改时间-开始
     * @return 系统用户数量
     */
    Integer selectSysUserCountByLastModifiedTimeStart(@Param("lastModifiedTimeStart") Date lastModifiedTimeStart);

}
